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What makes a dev platform? 


• Fast iteration time 


J z 

• Content ‘Hf 1 



• Native code 

1 ■ ■ ■ ■ | 




• Debuggability 

• Game-play script 


• Native code 

• Graphics %if ] 
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Developing BA on mobile devices 

• Some of the stuff we did on device 

• Game-play programmer wrote touch controls 

• VFX artist checked and optimized effects 

• Fix shader bugs 
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Double Fine development pipeline 

• Target platform: SS. ^ & 

• Code: compiled on target platform 

• Data: shared, authored on Windows 

• Same hardware 

• Performance characteristics similar 

• No per-platform content 
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Content workflow Sg ^ & 


Iterate 
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Double Fine development pipeline 

• Target platform: (QS ifli 

• Code: compiled on OSX 

• Data: not shared, authored on Windows 

• Hardware is very different 

• Performance varies greatly 

• Platform / GPU specific data necessary 
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Content workflow QQ ip 


Iterate 
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Mobile as development platform 


• Broken Age Act 1 package size: ~1.2GB 


• Reboot time was ridiculous! 

• (5g~io minutes* 

• 4 8-21 minutes 

• Infeasible for development! 



* Recent Xcode update reduced reboot time to 2 - 3 minutes 
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Too slow 

• What is going on? 

• Relink and update staging data: 10+ seconds 

• Data sync and install: ~10 minutes 

• Sync (comparison and copy) is bottleneck 
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Incomprehensibly slow 


• What is going on? ijpi 

• Package build time: 4+ minutes 

• Data transfer and install: 4-17 minutes 

• USB speed is bottleneck 
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Slow content update 

• Same symptom but different cause 

• Different solutions required 

• Minimize APK size 

• ma Work around Xcode data sync 
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Fast content update iff 

• Minimal APK: No data, just code 

• Reduced package build time 

• Fast APK transfer and installation 

• Deal with data separately 

• Only copy added or changed files 
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Fast content update iff 

• Load assets from 'sdcard' 

• Supported by (almost) all Android devices 

• Remap file location 

bool RemapFilename ( const char* filename, char* remapped ) { 

#if _DEV 

sprintf (remapped, " /sdcard/dfp/df a/%s" , filename); 
return FileExists (remapped) ; 

#else 

return false; 

#endif 


} 
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Fast content update iff 

• Data sync 

• 1 st approach: Consistent file database 

• Sync changes using ADB (e.g. adb push ...) 

• Keep track of files on device 

• Update database during sync 

• Slow and inconvenient 

• Multiple devices: Per-device database?! 
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Fast content update 'jp 


• Data sync 


• 2 nd approach: Scan device files 

• Naive implementation is slllooooowwww.... 

• Re-implement ADB protocol based on OS source 


https ://android. googlesource. com/platform/system/core. git/+/master/adb/ 
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Fast content update iff 

• Data sync 

• 2 nd approach: Scan device files (cont.) 

• Example: List directory 

socket . send (pack ("LIST", 15, "/sdcard/ dfp/dfa") ) 

while True: 

id, mode, size, time, namelen = unpack (socket . recv (16) ) 
name = ' ' if namelen == 0 else _recvall (socket, namelen) 
if id == "DONE": break 
if stat . S_ISDIR (mode) : 
dirs . append (...) 
elif stat . S_ISREG (mode) : 
files . append (...) 
return (dirs, files) 
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Fast content update iff 

• Data sync 

• 2 nd approach: Scan device files (cont.) 

• Compare files and compute diff 

• Sync files using ADB protocol 

• Very fast 

• No database 
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Fast content update iff 

• Results 

• Data sync: 15 - 25 seconds 

• APK build, copy and install: 30 - 40 seconds 


10 - 20+ speedup! 
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Fast content update flga 

• Minimal staging folder 

• Delete unchanged files 

• Copy only added or changed files 

• Use sync timestamp 


Reduced work for Xcode 
No run-time changes necessary 



Fast content update flsa 

• Results 

• Relink and update staging data: 15+ seconds 

• Data sync and install: 30 seconds 


13 speedup (latest Xcode 2-4 speedup) 
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Mobile as development platform 

• Ideal workflow 


Iterate 


Windows workstation 

• Author data 

• Process data 



Test 


PVR 

1 

tftia 

ETC1 



DXT 


w 

PVR 


ATC 
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File streaming 

• No re-sync necessary* 

• Hot-reload changed files 

• No OSX workstation needed 

• Artists can work on target device 


* Code changes require re-sync 
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File streaming 



Client 

Game session on device 



fopen(), fread() ... 

^\r 


\ 


Manager 

Worker thread 1 •* 777 

send ( ) 


Worker thread 2 * 
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\ 

Server 

Python-based tool on workstation ft 




* Script file A 

Server thread 1 ^ DXT file B 
Server thread 2 * — ► DXT file C 

PVR file D 

J 


recv ( ) 
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File streaming 


• Latency optimization 

• Use local file cache 


Client 

Game session on device 


io<; 


4 

I 

f read (out. 


T 

64, 1, fp) 



Server 

Python-based tool on workstation 


Cache * 

File cache 






j 
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File streaming 

• Latency optimization (cont.) 

• Read at least one cache line 


Client 

Game session on device 

4 | 

! T 

fread(out, 64, 1, fp) 


64 


File cache 



Server 

Python-based tool on workstation 


send ( ) ] 


recv ( ) 
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File streaming 

• Latency optimization (cont.) 

• Exploit data locality 


* 

ir 


Client 

Game session on device USE 

4 | 

! T 

fread(out, 4, 2, fp) 


.V 




8 




rV 


File cache 


Server 

Python-based tool on workstation 
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File streaming 


• Latency optimization (cont.) 

• fstatQ & fopenQ read first cache line 


Client 


Game session on device 


4 


T 



Server 

Python-based tool on workstation 


f open (name, 'rb' ) 


a 


1 1 





File cache . sendo 

k 

recv ( ) 




2 5 6KB 
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File streaming 


• Latency optimization (cont.) 



Cache expires after 5 ms to avoid stale data 
Multiple concurrent requests 
User filter to define streamed 

• Local 10 will always be faster 
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File streaming 


• Fully integrated into our game editor 2HB 


H «* <* ► ► II I Q 1 Cl 1 

UsarConfigJua | . mun.lui - GanwCo^ka - OoudColony.ElWc.lua □ 

I 'Basket!' . 

L » 


B function CloudColony_Elder :_init(rScene) 
self . sGuardStateOefault - 1 
self . sGuardStateUnconscious • 2 
self . sGuardStateWokeUp - 3 

self. rOirl - Entityttanager .getEntityNamed! 'Girl' ) 

self .rLadderBot ton - EntityManager.getEntityNamed! ' LadderBotton' ) 

self . rExittoForest - Ent ityManager. get EntityNamedC Exit. To.Forest ' ) 

self.rGate - EntityManager.getEntityNamedCElderGate' ) 

self.rGuard - EntityManager.getEntityNamed('ElderGuard') 

self.rElder - EntityHanager .getEntityNamedf 'Elder ' ) 

self.rExitTotlain - EntityManager getEntityNanedf 'Exit.ToJIain' ) 

self .r8asket1 - EntityManager . getEnt ityhanedf ' Basket 1 ' ) 

self . i Basket2 - EntityManager.getEntityttaaiedl 'Basket2' ) 

self .rBasket3 - EntityWanager.getEntityManed( Basket 3') 

self .rBaskets • EntityManager . getEnt ityNa*ed( 'Elder Cloudlower ' ) 

self .rGoldenEgg - EntityManager. getEntityNaaedf 'StoneEgg') 

self . i Inter inEgg - EntityManager .getEntityNaned! ' Inter inStoneEgg' ) 

self . rNearGuardTV - EntityManager .getEntityNanedC 'TvJiearGuard' ) 

self. rNestBirdA - EntityManager. getEntityNaaed('NestBirdA') 

self .rNestBirdB - EntityManager .getEntityNaned! NestBirdB' ) 

self .rObstruction • Ent ltyManager. get Ent it yNaraed! 'BrokenObst ruction ' ) 


-- register for their interactions 

self . rGuard.dlnteract : register! self .onlnteract , self) 
self . rLadderBotton.dlnteract register (self .onlnteract. self) 
self . rBasket 1 . dlnteract : register ( self . onlnteract . self ) 
self . rBasket2 .dlnteract : register! self .onlnteract , self) 
self . rBasket3 .dlnteract : register! self . onlnteract , self ) 
self . rGoldenEgg . dlnteract : register ( self .onlnteract . self ) 


B 


if rot GaneStateManager ,getValueFor( ' CCEJjVictoryPlayed ' ) then 

self rMearfirwrdrv fnTrieeerVnlime rklnEnter resisted self nearfiuar 


No default env state specified for Data/Scenes/GreenScreen. scene 
Could not find reverb preset GirlDefault 
Default Reverb Preset GirlOefault not found skipping 
Gamestate: Add 'SBS.bWearingHelnet' -> 'false' 

Gamestate: Add ' SBS.bMelmetOn ' -> 'false' 

Could not find reverb preset GirlOefault 

Default Reverb Preset GirlOefault not found skipping 

[process stopped] 


CommoiVCode/lua 

Common/Code/Moal/src/lua-modules 

Dfa/Data 

Dfa/Unmunged 

Dfa/Win/.Cache 

Dfa/Axt/.Cactie 



- 
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Conclusion 


Mobile as development platform is... 

• ...not trivial 

• ...worth your time 

• ...necessary for project 
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Thank you! 
Questions? 
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